=====================================================================
  MAGIC SCHOOL LUNAR!  (Mahou Gakuen Lunar!)  -  English Translation
  Sega Saturn  -  Patch v1.2.1
=====================================================================

Ellie and Lena, two village girls who can fly, are scouted for the
Magic School on Ien, a floating island that sails from place to place.
Game Arts' 1997 Saturn remake of Lunar: Walking School, never released
outside Japan - now fully playable in English.


---------------------------------------------------------------------
 QUICK START (Windows)
---------------------------------------------------------------------
 1. Unzip this archive anywhere.
 2. Double-click  Patch_Windows.bat  and pick your disc image's .cue
    file when asked. (If you put these files in the same folder as the
    .cue, it is found automatically.)
 3. A new folder "Magic School Lunar! (English v1.2.1)" appears next to
    your original .cue. Play the .cue file inside it.

 Not on Windows? See METHOD B under HOW TO PATCH.


---------------------------------------------------------------------
 WHAT'S TRANSLATED
---------------------------------------------------------------------
 * All story dialogue: prologue + chapters 1-12 (about 10,750 messages)
 * Menus, status screen, settings, save/load screens
 * Items, every spell name and description, battle commands and
   messages, enemy names and enemy attacks
 * Party names in the field and battle displays
 * English subtitles for the anime cutscenes (spoken dialogue; the
   theme song is left unsubtitled)
 * Text drawn as pictures: the title logo (MAGIC SCHOOL above LUNAR!),
   the save-device labels and all 12 chapter title cards
 * New English font (two-letter tiles drawn in the game's own font
   format, so no game code had to be rewritten to display English)

 LEFT IN JAPANESE ON PURPOSE
 * The voice acting. The original Japanese performances are kept as they
   are; every spoken line in the anime cutscenes has English subtitles.
 * The opening theme song is not subtitled.
 * The ending staff roll keeps the original Japanese credits, so the
   staff are credited exactly as they were.


---------------------------------------------------------------------
 WHAT YOU NEED
---------------------------------------------------------------------
 The Redump disc image  "Mahou Gakuen Lunar! (Japan) (2M)"
 (a .cue file plus 28 .bin tracks). Only Track 01 is patched.

   Track 01 before patching
     Size   454,643,952 bytes
     CRC32  3CC5331F
     MD5    7235EB0892CE34A4A996FC95AFF9687F
     SHA-1  FCDCC837B7BD233E06ACB687DBB264307234037D

   Track 01 after patching
     CRC32  CB540D89
     MD5    29B05FC9AD79995B63136E5CD3CAFE4D
     SHA-1  CC5CB02DBF81460CFED133894207874B35D5CF35

 This patch contains no game data you can play by itself. Please use a
 copy of the game you own.


---------------------------------------------------------------------
 HOW TO PATCH
---------------------------------------------------------------------
 This archive contains two ways to patch; use whichever suits you.
   Patch_Windows.bat, Patch_Windows.ps1, patch_data.msl  -> Method A
   MSL_English_Track01.xdelta                             -> Method B

 METHOD A - Windows, one click (nothing else to install)
   1. Put all the files from this archive in the same folder as your
      disc image's .cue file. (If you keep them somewhere else, the
      patcher asks you to pick the .cue file.)
   2. Double-click  Patch_Windows.bat
   3. A new folder "Magic School Lunar! (English v1.2.1)" appears with the
      patched disc (.cue + 28 .bin files). Your original files are not
      changed. The patcher checks the image before and after patching,
      and takes about a minute.
   If Windows shows a "Windows protected your PC" notice, choose
   "More info" -> "Run anyway". The patcher only reads your disc image
   and writes the new copy; it does not connect to the internet.

 METHOD B - Any system (xdelta)
   Apply  MSL_English_Track01.xdelta  to
   "Mahou Gakuen Lunar! (Japan) (2M) (Track 01).bin"
   with any xdelta3 tool:
     - Windows: Delta Patcher or xdelta UI
     - macOS / Linux / command line:
         xdelta3 -d -s "Mahou Gakuen Lunar! (Japan) (2M) (Track 01).bin" MSL_English_Track01.xdelta "Track 01 (English).bin"
   Then replace Track 01 with the patched file. Keep the name the .cue
   expects (or edit the .cue), and keep tracks 02-28 next to it.


---------------------------------------------------------------------
 HOW TO PLAY
---------------------------------------------------------------------
 * Emulators: tested in Mednafen. Other accurate Saturn emulators
   (Beetle Saturn, SSF, Kronos) should work but are untested.
 * Real hardware: works from an optical drive emulator such as Fenrir.
   This is a Japanese game: a non-Japanese Saturn needs a region-free
   BIOS/mod or your ODE's region setting.
 * Burned discs are untested.

 Tips
 * Start from a fresh boot. Do NOT load emulator save states made with
   the Japanese version or an older patch - they restore the old font
   and text from memory and the screen turns into nonsense.
 * In-game saves (the game's own save files) are kept in the
   Saturn's internal/backup memory as usual.


---------------------------------------------------------------------
 TRANSLATION NOTES
---------------------------------------------------------------------
 * A few names are shortened where the game's menus have fixed room:
   Hanahime Ranbu = Petal Rush, Ikoi = Repose, and in the field magic
   list Frost Blade appears as "Frost". Some item names are compact
   (Palas Rock, Wake Tonic, Astral Gem). Dialogue uses the same names.
 * Battle commands fit 4-letter windows: Duel / Flee, then
   Hit / Ward / Cast / Combo.
 * Honorifics are dropped; teachers are Mr./Ms. (Ms. Emma, Mr. Iason...).


---------------------------------------------------------------------
 KNOWN ISSUES
---------------------------------------------------------------------
 * Some long names or labels may look tight in a few windows; the game's
   window sizes were designed for Japanese.
 * Please report anything that looks cut off, garbled, or mistranslated,
   ideally with a screenshot (see FEEDBACK below).


---------------------------------------------------------------------
 TECHNICAL NOTES (for hackers)
---------------------------------------------------------------------
 * Dialogue: S00-S12.FLD chapter archives (Shift-JIS, pointer tables).
   The archives are repacked back-to-back into the free space at the end
   of track 1 (the game loads files by name, so this is safe).
 * Font: KANJI.FNT (16x16). 1,501 kanji slots redrawn as English letter
   pairs; the code list is unchanged.
 * Menus/battle: strings in program modules 0, 1 and 2 (loaded at
   0x06018000), written in place or repointed; half-width strings (party
   names, compact spell names) use ASCII.FNT.
 * Cutscenes: MSLM.FLD (Sega FILM / Cinepak). Only the stretches with
   subtitles are re-encoded, keyframe to keyframe; every movie keeps its
   exact size, and audio and video samples stay contiguous and never
   arrive later than in the original stream.
 * Pictures: MISC.FLD (title logo and labels = entries 0-2, title
   background = 5) and CHAPTER.FLD (title cards),
   all LZSS like Okumura's (4 KB zero-filled window from 0xFEE,
   LSB-first flags). Every entry stays inside its original slot.
 * Every changed CD sector has correct EDC/ECC.


---------------------------------------------------------------------
 VERSION HISTORY
---------------------------------------------------------------------
 v1.2.1 Fixed garbled text in five lines the earlier versions missed:
       Mr. Iason's greeting in the dojo (chapter 1), two lines during
       the earthquake at the end of chapter 1, and a broken-bridge
       message in chapter 3. The whole script was re-swept for others.
 v1.2  Picture text translated: title logo, save-device labels and the
       12 chapter title cards.
 v1.1  English subtitles for the anime cutscenes; translation credit
       on the title screen and at the end of the opening animation.
 v1.0  First release: dialogue, menus, items, spells, battle text.


---------------------------------------------------------------------
 FEEDBACK
---------------------------------------------------------------------
 Found a bug, a typo, a line that reads oddly, or have a request or
 other feedback? Send it to:

     justin@tooncesoft.com

 Screenshots help a lot. Please mention where in the game it happened
 (chapter, place, or what you were doing) and whether you were playing
 on an emulator (which one) or real hardware.


---------------------------------------------------------------------
 CREDITS
---------------------------------------------------------------------
 English translation, hacking, subtitles and patcher:
                         Justin Grimes / Tooncesoft
 Original game:          (C) 1997 Kadokawa Shoten / ESP / Game Arts /
                         Studio Alex

 This is an unofficial fan translation, not affiliated with or endorsed
 by Game Arts, Kadokawa, GungHo or Sega. Do not sell this patch or
 distribute it bundled with the game.
